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BUILD P HELPFUL HINTS 



This paper describes helpful hints on how to use build P of 
NOS/VE. It is intended to supplement* rather than to replace* 
the standard NOS/VE documentation. If you have any qustions or 
suggestions* please see Tom McGee or Bonnie Swierzbin. Appendix 
A lists background documents and how to obtain them. 

To obtain additional copies of this document white running on 
SN101 at Arden Hills* please type? 

SESt DEV1.LISTPH C«<number of copies> 

To obtain a copy with revision bars against the Helpful Hints of 
the previous build* please types 

$ES*DEV1.LISTPH REVB (Xnumber of copies> 

The C parameter is optional and defaults to one. 

UaaVaifi-fcliatoxs 

Date Changes 

12/22/80 Revisions for NQS/VE Phase C 

2/12/81 Additional revisions for NOS/VE Phase C 

6/9/81 Revisions for NOS/VE Build N 

6/19/81 Additional revisions for NOS/VE Build N 

8/28/81 Revisions for NOS/VE Build 

11/6/81 Revisions for NOS/VE Build P 
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© All existing commands have been updated to Revision 8 of the 
ERS. In addition* parameter abbreviations have been added for 
all commands. This involved some renaming of parameters from 
what «as previously implemented* and in some cases? from what 
was described in the ERS. 

A description of the parameter names that have been changed 
and the algorithm for deriving the abbreviations can be found 
in the COMMAND INTERFACE STATUS section of this document. 

o The long awaited message generator is available! Henceforth? 
In most cases? rather than a condition code and raw status 
record text? you will see formatted messages and their 
designated severity. The exceptions will be for any remaining 
HCS condition codes and? of course? conditions for which no 
message templates have been defined. Feedback with regard to 
the intelligibility and usefulness of the messages you 
encounter would be greatly appreciated* comments on this 
subject should be given to C.G. Nelson (ARH263? X2750) 
preferably in writing. 

When a job is initiated? the message mode is set to brief* 
This means that the Identifier and condition code for a 
message will not be shown! i.e. you will only see a severity 
designator and a formatted message? the severity designator 
for informative messages is omitted. If you really want to 
see the condition code? use the SET_MESSAGE_MODE FULL 
command. In full mode the severity designator for informative 
messages is included. 

o Interactive Usage Restrictions! When logging in to NOS/VE 
(i.e. HEtL0?TAF etc.) do not enter a terminate break (CTRL 
t) or a pause break (CTRL p) before the 'welcome message 1 
appears at the terminal. A pause or terminate break entered 
before the interactive NOS/VE job has completed it's 
initialization may crash the system. 

A REQUEST_TERMINAL command in a batch job will crash the 
system. This can happen accldently through a REQUEST_TERMINAL 
command in a user prolog when the user runs a batch job since 
the prolog is executed for both interactive and batch jobs. 
The problem can be avoided by making the REQUEST_TERMINAL 
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command in the prolog conditional on the job type as follows* 

IF $J0BIH0DE) <> 'BATCH* THEN 

REQUEST.TERNINAL 
IFENO 

The LOGIN and LOGOUT commands have been implemented* This 
includes the processing of system and user prologs and 
epilogs* Since prolog processing is now done automatically at 
login* the SETUP command has been deleted* The default for 
the FAHILY_NAME parameter is Inherited from the submitting job 
rather than set to an operator provided default as specified 
in the ERS* 

The system prolog consists of processing the $SYSTEM*SYSPROF 
file as was done previously by SETUP* If any errors occur 
during system prolog processing* the user job is aborted in 
both Interactive and batch modes* 

User prolog processing consists of attempting to attach a file 
called PROLOG in the SUSER catalog* If unsuccessful * an 
attempt Is made to get the file PROLOG from the user's 170 
catalog; if this is successful* the file is saved in the $U$ER 
catalog for subsequent accesses* If the file PROLOG is now 
available* it is INCLUDEd; otherwise nothing further is done* 
If any errors occur during user prolog processing* batch jobs 
are aborted and interactive jobs continue* 

User epilog processing consists of the same steps as user 
prolog processing except that the file involved is EPILOG and 
if errors occur* processing continues with the system epilog* 

The system epilog is an empty procedure for the time being* 

LOGIN automatically issues a LINK_USER command for the user 
logging In* In addition* LINK_USER now works as documented in 
the ERS* that is issuing a LINK_USER after login changes the 
job setting rather than aborting* 

The contents of the SSYSTEH catalog can be displayed using the 
OISPLAY.CATALOG SSYSTEM command. 

Up until now if nn error occurred at the "first level** in 
batch jobs H.e* the command came from the file COMHAND) the 
error was reported and the job continued processing commands* 
This is no longer true; an error at the first level will cause 
batch jobs to be aborted* 

The file SRESPQNSE is no longer connected to the file OUTPUT 
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In batch jobs* The CONNECT_F HE command may fee used to make 
this connection if desired* 

The "Welcome to NQS/VE *** M banner is no longer written to 
SRESPONSE* It is now written to OUTPUT and only in 
interactive jobs <i*e* not in batch or console jobs)* 

o The GET_FILE and REPLACE. FILE commands have been implemented 
and they take the place of the procedures that were available 
in previous builds* The HCS GET and REPLACE commands have 
been withdrawn* 

o Permanent file catalogs and object libraries can be included 
in the command list via the SET_CQMMAND_LIST command* Both 
SCL procedures and program descriptions can be directly 
executed with the necessary files being automatically 
attached* 

o In PROC declarations* FILEREF is no longer a valid SCL 
parameter type* The FILE specification should be used instead 
and is the default* 

Also the APPLICATION specification has been changed froms 
APPLICATION <sp> ^application value procedure name) 

to s 

Application value name t<sp> Application value procedure 
name>3 

o The DISPLAY_FILE_STATUS command has been renamed to 
DISPLAYJ>RINT_STATUS* 

o The CATALOG parameter for the DISPLAY_CATALQG command now 
defaults to the working catalog rather than being required. 

o The new version of DISPLAY_LOG has the following parameters? 

DISPLAY.LOG DISPL AY.OPTIONSs DISPLAY_0PTI0N, DO* INTEGER or 
KEY all* iast*al I 
OUTPUT* 0«$outPut 
STATUS 

The parameters are defined as documented in the command 
interface* however* regardless of the number pf lines 
requested to be displayed* only the last line Is displayed* 
The TYPE parameter has been removed* DISPLAY.LOG can only 
display the user»s job log* 

o CLP$PUT_STND_OUT has been deleted. Calls to CLP$PUT_STND_GUT 
should be replaced by calls to either CLP$PUT_JOB_OUTPUT (deck 
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CLXOUTI or CLP$PUT_JQB_COMMAND_RESPQNSE Cdeek CLXRESP) which 
Mill write to the files OUTPUT and SRESPQNSE respectively. 

o The modifications made to the type pmt$program_descr I pt I on 
Cdeck PMDPRGXJ require that users of PHPSEXECUTE recompile. 

o In addition to the renaming of parameters and adding all 
parameter abbreviations that occurred in this build* the 
command names will be renamed as well. In this build the only 
commands that have been re Implemented in their new form are 
the subcommands for the CREATE_GBJECT_LIBRARY utility. The 
new subcommands are documented In the new version of the 
command interface. To obtain a copy of the new command 
interface for CREATE.0BJECT.LI8RARY simply type 
SES»MAD.LISTNCI S»ll on SN101 at Arden Hills. 

The old subcommands for the library generator are supported as 
well as the new subcommands. The only I ncompat i bl i ty with the 
old ERS is the removal of the I parameter from the 
CREATE_GBJECT_LIBRARY command. The equivalent capability can 
be realized by calling CREATE. OBJECT^LIBRARY and doing an 
INCLUDE on the file that would have been specified with the I 
parameter. 

The new parameter names and abbreviations can be determined by 
using the DISPLAY_C0MMAND_INFGRMATION command. 

o Any product or utility that is placed in the SSYSTEM catalog 
(or any frequently loaded program) should be bound using the 
CREATE.MOOULE subcommand of the CREATE J3BJECT.LIBRARY 
utility* This will minimize overhead associated with loading 
the product or utility. 

o The PMP$GENERATE_UNIQUE_NAME program interface has been made 
available. This is of particular importance to all utilities 
and products that use names for intermediate files or local 
queues; unique names should be used for these names to allow 
successful asynchronous execution of the utility or product. 

o Date and time are now copied across from NOS at every 
deadst art. 

o Debug responds to terminal breaks when a program is being 
debugged. However* entering a pause or terminate break when 
debug is active (I.e. the DB/ prompt has appeared and the 
user has not issued the RUN command) will cause the task to 
terminate* 

o Permanent Files still are permanent only until a crash or 
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deadst art . 

o You can cause SCL to output the commands being executed from a 
procedure or Include file by doings 

connect.fi le $ECHO OUTPUT 

o When sharing executable files via permanent files (i.e. 
compilers* libraries* etc.) you should make the file an 
object library via the CREATE_08JECT_LIBRARY utility. By 
sharing object libraries instead of object files* the code is 
actually shared among all tasks using the library; the library 
Is not copied to another segment but is executed directly. 

o The file(s) specified by the FILE parameter on the EXECUTE 
command may not be object library files. 

o The program option PRESET now works. 
1*1 Ba£l¥£-U2A££_£U£1£U£ 



1.1.1 EXECUTING PROGRAMS 



LIMITATIONS 

— The file(s) specified by the FILE parameter on the EXECUTE 
command may not be object library files. 

PROCESS 

Create an object text file by compiling a program on NOS. Then 
perform the following steps on NOS/VE: 

— Acquire any necessary libraries {which are oat quoted in text 
embedded directives) by either: 

o Attaching them from the system catalog* either explicitly 
or via prolog 

or 
o Creating the library file via the object library generator 

or 
o Staging the library file from NOS to NOS/VE using the 
GET_FILE command with B56 conversion mode specified. 

— Get the file from NOS and convert the object text file from 
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the CI data mapping to II data mapping by executing the 
CONVERT.OBJECT.FILE command. 

- toad and execute the program via the EXECUTE command* 
specifying the necessary libraries with the LIBRARY parameter; 
alternatively SET_08JECT_LIST may be used to include the 
libraries in all subsequent EXECUTE commands. 

Stage the loadmap from NOS/VE to NOS for printing by using 
e$ tfcer : 

o The REPLACE..FILE command with A6 conversion mode specified 
if running on the simulator. 

or 
o The PRINT command if running on the hardware. 

EXAMPLES 

The following is an example command sequence for executing a 
program not requiring any libraries for loading: 

Assumptions: all modules to be loaded are contained on the NOS 
permanent file •citxtrs*. 

CONVERT_OBJECT_FILE CITXTRS 

EXECUTE CITXTRS PARAMETER-' progr am parameters* 

PRINT LOADMAP 

The following is an example command sequence for executing a 
program requiring libraries for loading: 

Assumptions: the NOS permanent file 'citxtrs* contains object 
text generated by the CYBIL CI compiler. The compiler modules 
reference procedures contained on the user library •mylib* and 
the CYBIL run-time library. These libraries have been generated 
on NOS/VE and saved on NOS* 

GET_FILE MYLIB DC»B56 

SET_PROGRAM_GPTIONS LOAD.MA P.OPTIONSM BLOCK* ENTRY. POINT* SEGMENT) 

CONVERT_OBJECT_FILE CITXTRS 

EXECUTE CITXTRS 'program parameters' LIBRARY*MYLIB 

PRINT LOADMAP 

1.1.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 
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o CLG0170 is NQS permanent file name for file containing CI 
object text for modules to be included in the library* 

o IITEXT180 is NOS/VE local file name for file containing II 
object text for modules to be included in the library* 

o LI8RARY180 is NOS/VE local file name for the library being 
created* 

o ILIB170 is NOS permanent file name for file containing the 
library* 

NOS/VE Job Commands 

C0NVERTJ3BJECT.FILE IITEXT180 CLG0170 

CREATE.08JECT.LIBRARY 

ADD.HGDULE LIBRARY«IITEXT180 

GENERATE. LIBRARY LIBRARY=LI8RARY180 

QUIT 

REPLACE.FILE LIBRARY180 ILIB170 DC-856 

1.1*3 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 



Notes 

o ILIB170 is NOS permanent file name for file containg the old 

library 
o LIBRARY180 is NOS/VE local file name for file containing the 

old I i br ary 
o CN0D170 is NOS permanent file name for file containing CI 

object text for the new module 
o NEWIINOOULE is NOS/VE local file name for file containing II 

object text for the new module 
o NEWLI8RARY is NOS/VE local file name for the library being 

created 
o NLIB170 is NOS local file name for new library 

NOS/VE Job Commands 

GET.FILE LIBRARY180 ILIB170 DC»B56 

CONVERT.OBJECT.FILE NEWIIMODULE CM0D170 

CREATE_08JECT_LIBRARY 

ADD.MODULE LIBRARY-LI8RARY180 

REPLACE.MODULE LIBRARY*NEWI IMODULE 

GENERATE. LIBRARY LIBRARY*NEWLIBRARY 

QUIT 

REPLACE. FILE NEWLIBRARY NLIB170 DC»856 
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1.1.4 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 



Running from an Interactive terminal* enter? 

G£T*f I lename. 

ROUTE* f 1 1 ename>DC*LPf FC «RH. 

The input file which is sent to NOS/VE must be In 6/12 ASCII 
Cor display code subset). The job file must be a single 
partition NOS record containing NOS/VE commands. The first 
statement must be a valid LOGIN command with user* password and 
family name specified. Multl partition Input files are not 
supported by NOS/VE so NOS data files used by the program must be 
obtained through the GET_FILE command. 

1.1.5 PRINT A NOS/VE FILE 



At NOS/VE job termination the job log will be automatically 
returned to NOS. The job log will be appended to the NOS/VE 
output file OUTPUT. NOS/VE print files must be written by BAH as 
8/8 ASCII RT*V. Print files will be converted from 8/8 ASCII 
RT»V to NOS 8/12 ASCII when they are sent to NOS and will be 
printed in upper/lower case. All NOS/VE output files will appear 
in the NOS output queue <NQS H>0 display) with the name IRHFxxx 
as a banner. In order to print a NOS/VE file* the following 
command must be issued within your job or be entered from the 
system console via the K displays 

PRINT LINKNAP 
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2.1 &£££SS-IQ-Easa£-Ifcl-£UAUmiE 



2.1.1 LOGIN TO NOS/VE 




» user* pass wor dp TAF 



You can access TAF from IAF by doing W HELLQ»TAF W or by 
answering TAF to the system prompt "APPLICATION:**. 

2.1.2 TERMINAL USAGE 



11 The slant if) is the prompt to enter a NOS/VE command. Any 

normal NOS/VE command can now be entered (continuation lines 

are prompted with ../). The full ASCII character sett lower 

or upper case and all special characters* can be used. 

2) A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate. A new NOS/VE Interactive Job can then be started 
by responding to the 'APPLICATION* « prompt with TAF. 

3) Terminal breaks Ccontrol-t and control-p) now work. It is 
possible to terminate a task or command and to suspend a task 
and enter a new task to process SCL commands. Control-t 
causes a terminate break and control-p causes a pause break. 
Terminate break will terminate a command or the most recently 
executed task. A pause break will suspend execution and 
allow commands to be entered. When a terminal is in pause 
break state* two commands are available* 
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RESUME - resume execution at the point of interruption. 

TERMINATE - cause a terminate break condition as if a 
terminate break had been entered. 

Both terminate break and pause break are avai table to programs 
as conditions via the program management condition mechanism. 



2.1.3 NQS/VE PROGRAM ACCESS TO THE TERMINAL 



1) Interactive NQS/VE jobs are able to obtain terminal input 
through the AMPSGET.NEXT or AMP$GET_PARTIAL program interface 
which can be used by both task services and user ring 
programs. Interactive programs which use this interface 
should be able to handle both upper and lower case input in 
order to make them more convenient to use in both 64 and 96 
character set modes. 



2.2 CQUMMa.Aita_£A&&&EI£R-!aA&£S 

Ouring the next few months a command supported by the system 
may not be in sync with your command interface document. The 
parameter descriptor table gives an accurate* concise description 
of the command interface as currently supported. 

The definition of a command f s parameter list is enclosed in 
parenthesis with a parameter description per line. Each 
description has the general forms 

PARAMETER NAME? ALLOWED PARAMETER VALUES * PARAMETER DEFAULT 
VALUE 

Parameter Names - describes the parameter name and any 
abbrev i at ions. 

Allowed parameter values - describes the kind of value allowed 
and whether a list of values Is possible. The value kind can be 
further qualified. In some cases* the actual values allowed are 
described using the KEY notation. The value kinds include 
INTEGER* STRING, NAME* FILE* STATUS. 

Parameter default values - describes the defaulting rules 
and/or values for the parameter. $REQUIRED and SOPTIONAL are 
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obvious. Other values in this position will be treated as if 
they were entered by the user on conand invocation. 

See the PROC command in the Command Interface ERS for more 
detai Is. 

The PDTs for the commands currently in the system can be 
displayed using the DISPLAY .CQMMAND.INFGRMATXON command. This is 
documented in the nonstandard command section of this document. 



2.2.1 PARAMETER NAMES AND ABBREVIATIONS 

The primary convention for a parameter name abbreviation is to 
use the first character from each word in the parameter name* for 
example* line^number would abbreviate to In. 

The status parameter is never abbreviated. Since this 
parameter is available on every command* the abbreviation , s* 
would not be available for any other parameters. 

Some abbreviations can be 'cluster universal* within a command 
cluster* i.e. within the source code utility or the permanent 
file commands. These abbreviations should be made the same even 
If an abbreviation could get by with fewer characters in some 
commands. 

Where a parameter can accept a list of one or more values and 
a plural form of the parameter name makes sense* both the plural 
and singular form are allowed. 

In some situations a parameter name is used as a parameter 
name on one command and as a value on another command or function 
(DISPLAY_FILE_ATTRIBUTES command and $FILE function for 
example). The abbreviations must be the same in both places. 

It Is not possible to follow this convention in all situations 

(i.e. some commands contain parameter names which would result 

In duplicate abbreviations). In this case judgement and 

consideration of human factors should be applied to determine 

abbreviations. When there is already a well known English 
abbreviation* use it. 

The abbreviations for PASSWORD? PW* MINIMUM: MIN and MAXIMUM? 
MAX do not allow the single letter convention to be followed* so 
an abbreviation was selected. 
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2.2.2 PARAMETER NAME CHANGES 



COMMAND NAME 



OLD PARAMETER NAME 



NEW PARAMETER NAHE 



att 

cha 
ti 

cha 
del 
del 
dls 
dis 
dis 
dis 
dis 
dis 
dis 
dro 
exe 

w 
ft 
ft 

f il 

n 
n 
« 
« 

get 
log 

n 

per 

N 



ach 
nge 

nge.pr ior i ty 

ete.catalog.permi t 

ete.permi t 

pi ay. catalog 

pl ay.command.l 1st 

play.f i f e 

pl ay.fi I e. at tributes 

pl ay.job. status 

P I a y. I o g 

Pl ay.termina l.attributes 

P-Job 

cute 



in 

wit 



perwi t.catalog 



pri 
t« 

rep 
req 

H 

n 

M 

t» 

set 

set 
n 

H 



ftt 

lace.fi I e 
uest.termlnal 



.message. mode 
.pr ogr am. opt ions 



share 




share. mode 


new. char ge 




new.account. project 


new.pf n 




new.fi 1 e^n^me 


name 




job. name 


f ami 1 y 
« 




f ami 1 y.name 

n 


type 




di spl ay. op tions 


i nf o.l evel 




M 


type 




« 


attr i butes 




n 


nasie 




job. name 


from 




disp 1 ay.op tions 


attributes 




n 


name 




job. name 


map 




load. map 


map.opti ons 




load. map. opt Ions 


preset 




preset. val ue 


procedure 




star ti ng.procedure 


max.bl ock.l 


ength 


max imum.b 1 ock.l ength 


max.r ecord. 


length 


maxi mum.record.l ength 


m i n.b 1 ock. 1 ength 


mimimum.bl ock.l ength 


mi n.r ecord. 


length 


mini mum.record.l ength 


user.l nf o 




user. inf ormat ion 


conversion 




data.conve rs ion 


f ami 1 y 




f ami 1 y.name 


name 




job. name 


appl i cation 


.info 


appl i cat Ion. inform at ion 


f ami ly 




f ami 1 y.name 


share 




share. mode 


app 1 i cati on 


.info 


appl i cat i on. i nf ormat ion 


f ami ly 




f ami 1 y.name 


share 




share. mode 


conver si on 




data. conver s ion 


form 




forms. code 


conversi on 




data.convers ion 


eoi. string 




end. of. i nf ormat i on 


eop.str 1 ng 




end. of. par t i t ion 


no. format. e 


ff ectors 


f ormat.ef f ectors 


page.wai t 




hold. page 


transparent 


.end. count 


tr ans par en t. char acta r .count 


i nf o.l evel 




information.ievel 


map 




load. map 


map. options 




load. map. opt Ions 


preset 




preset.val ue 
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subflil t 
sn I tch 
terminal 

« 

N 
It 



name Job.name 

eol. string end_of_l nf orniat i on 

eop_string end_of_par t i t ion 

no_f or ma t_ef factors ?ormat_ef factors 

page.wait hold_page 

transparent_end_count trans par ent_char acta recount 



2.3 aGHMtm-EUMaioas 



EuGc.jtig.a_ 

$H0D 

SCHAR 

$CL0CK 

$DATE 

SFILE 

$FNAME 

SINTEGER 

$NAHE 

$ORD 

$REAL 

SSTRING 

*STRIEN 

SSTRREP 

SSUBSTR 

SUNIQUE 

$TIME 

$VAR 

SSPECIFIED 

$SET_C0UNT 

SVALUE.COUNT 

SRAMGE 

SPARAMETER.LIST 

SPARAMETER 

SSTATUS 

SCONOITION 

SSEVERITY 

SPRQCESSOR 

$408 



Siaius 



unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

unch 

new 

new 

new 

new 

new 



anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 



2.4 SXSI£a_4££ES£-CQaHAfcLB£ 



£p.iiaQ4&. 



Slain & 
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UNK.USER 
LOGIN 
LOGOUT 
PASSWORD 



Updated to 
Updated to 
unchanged 



Rev 

Rev 



ERS 

t K £> 



- *1 



*1 The family name of the job doing the submit will be used as 
the default family name on batch jobs* The default for jobs 
submitted from NOS will be family SSYSTEM* This effectively 
means that whenever NOS/VE jobs are submitted from NOS the 
family parameter is required* 



2.5 &E£aUR£E-JMA£Efi£8I 



REQUESTJTERMINAL 



Status 

unchanged 



2.6 £lL£-ttAHAfi£tt£liI 



FILE 

COPY 

DUMP. FILE 

COMPARE 

DISPLAY_FILE_ATTRIBUTES 

SKIP 



Status 

unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



*1 Multiple FILE commands will not be merged* 



2.7 E£fiflAfl£MXJEIL£.l!At!4fi£!l£ifI 



- *1 



£aiia&4- 

HCS GET 

HCS REPLACE 

GET.FILE 

REPLACE. FILE 

DEFINE 

ATTACH 

PURGE 

CHANGE 

PERMIT 



Status 

removed 

r emoved 

new 

new 

unchanged 

WAIT parameter supported 

unchanged 

unchanged 

unchanged 
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2,0 COWHAND INTERFACE STATUS 
2.7 PERMANENT FILE HANA6EMENT 



DELETE.PERHIT unchanged 

DEFINE_CATALOG unchanged 

PURG£_CATALOG unchanged 

DELETER ATALOG_PERN IT unchanged 

PERNIT.CATALGG unchanged 

DISPLAY_CATALOG unchanged 

OISPLAY_FILE unchanged 

SET_KQRKING_CATALOG new 

Permanent File Deficiencies 

1« Permanent flies on N0S>/VE are only permanent until a NOS/VE 
deadstart* 



2.8 a£L-mi£a£&ia_&na-£sa££j}n&£a 

CammaQd- Status 

PROC/PRQCEND unchanged 

SET_COMMAND_LIST unchanged 

DISPLAY_COMNAND_LIST unchanged 

REPEAT/UNTIL unchanged 

WHILE /WHILEND unchanged 

DECLARE.VARIA8LE unchanged - *1 

REMQVE.VARIABLE unchanged 

8LOCK/BLOCKEN0 unchanged 

LGGP/LGOPEND unchanged 

FQR/FORENO unchanged 

IF/ELSEIF/ELSE/IFENO unchanged 

CYCLE unchanged 

EXIT unchanged 

WHEN/WHENEND unchanged 

CONTINUE unchanged 

CANCEL unchanged 

INCLUDE unchanged 

CQLLECT.TEXT unchanged 

DISPLAY.VALUE unchanged 

EXIT.PROC unchanged 

ACCEPT unchanged 

DO unchanged 

CONNECT.FILE unchanged 

DISCONNECT^ ILE unchanged 

DISPLAY_CONNECTION unchanged 

change HCS variable unchanged 

display HCS variable unchanged 

*1 Variables can no longer be declared with the same names as 
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2,0 COMMAND INTERFACE STATUS 

2.8 SCI STATEMENTS AND PROCEDURES 



the boolean constants* 



2.9 iMifc&AamE-nattmABQS 



RESUME 

TERMINATE 

TERMINAL 

DISPLAY.TERMINAL.ATTRI3UTES 



Status 

unchanged 
unchanged 
unchanged 
unchanged 



2.10 Qkl£CI.£QG£-MI!iIEMMC£ 



CLanaajL. 

CREATE. 08 JECT.LIBRARY 

DISPLAYJ.I8RARY 

SELECT.DISPLAY.LEVEL 

ADD 

REPLACE 

COMBINE 

CREATE.MODULE 

BIND. MODULE 

DEFINE.PROGRAM 

DELETE 

CHANGE 

SATISFY 

REORDER 

GENERATE 

QUIT 

CI to II Conversion 



Status 

new - *1 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

command name change 



- *2 



*1 CREATE.OBJECT.LIBRARY and the abbreviations CREOL and COL are 
available as commands rather than SCL procedures in this 
build. In addition, CRE ATE.08JECT.LIBRARY supports both its 
previous names for subcommands as well as the new names 
documented in the command and parameter name changes DAP. 

The I parameter supported by the old COL procedure is not 
supported by the new commands. The equivalent capability can 
be realized by catling CREATE.OBJECT.LIBRARY and doing an 
INCLUDE on the file that would have been quoted on the I 
parameter. 

*2 Users of CITOII and 08JLIST should use the new procedures 
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2.0 COHHAND INTERFACE STATUS 
2,10 OBJECT CODE MAINTENANCE 



CONVERT.OBJECT.FILE and DISPLAY.GBJECT.TEXT. These procedures 
are described elsewhere in this document. The CITOII and 
OBJLIST procedures Mill be removed in the next build. 



2.11 US£&_SEE¥I£ES 



DISPLAY.LQG 

COMMENT 



Status 

new parameters 
unchanged 



3.12 EILE.&QUIItiS 



HCS JHROUTE 



Status. 

unchanged 



2.13 ££Q£RAM-£X£CUIiaB 



*1 



tfljaaaad- 

SET_OBJECT_LIST 

SET.PROGR ADOPTIONS 

DISPLAY.PRQGRAH 

EXECUTE 

"naie cal I" 

TASK/TASKEND 

TERMINATE.TASK 

WAIT 

SET_DEBUG_RING 



Status 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

new 

new 

new 

unchanged 



- *1 



kULQiQa — "name call" works only for SCL procedures unless a 
FILE command has been issued to specify that the 
FILE. CONTENTS are OBJECT and the FILE.GRGANIZATION is DATA or 
LIBRARY. The FILE command must be reissued every time the 
file is attached or brought over from N0S» 



2.14 *LQ&_ilA£i4££tt£!*I 



Canaad- 



Status 
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2.0 COMMAND INTERFACE STATUS 
2,14 JOS MANAGEMENT 



SUBMIT unchanged 

DISPLAY_JOB_STATUS unchanged 

DROP. JOB unchanged 

PRINT unchanged 

DROP. FILE unchanged 

DISPLAY_PRINT_STATUS unchanged 

In this build* several NOS/VE commands have been imp I emented 
as SCL procedures in order to make the system look more like the 
final version* Users are urged to use these procedures rather 
than their Interim counterparts since the interim commands will 
ultimately be withdrawn. 

These procedures will be made available via the default system 
pro log. 

2.16 MQ£i.mblMg2-£Q&3&!ig£ 

The following commands provide a nonstandard means of 
performing various frequently performed functions* They will be 
superceded in subsequent builds by standard commands and 
capabi 1 it i es* 

2.16.1 display_cgmmand_infqrmation J DISCI 

The purpose of this command is to display current information 
about a NOS/VE command. The parameter names* abbreviations* 
allowed values and known problems for a command* ns supported in 
the current system* can be determined. This is a nonstandard 
command and will be replaced by the help utility sometime in the 
future. 

displ ay_command_lnf ormat ion eommand_name*<name>i al I 

Cuti 1 i ty.name^create.ob ject_l Ibr ary * 

col 5 sour ce_code_ut 1 1 ItySscu! system! 
Cdispi ay_option*par amet erodes cr I pt ion. 

pdt* notes ! names' hel pi 
Coutput*<f 1 le referenced 
Cstatus*<status variable>l 

command_name!cn* This parameter specifies the name of the 
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command about which information is to be displayed* 

uti I I ty^nameluns This parameter specifies which utility the 
command belongs to. Omission will cause SYSTEH to be 
used. 

displ ay_option»doi This parameter specifies the type of 
display being requested. The options are* 

parameter_descr iption.tab le'pdt - selects a display of 
the parameter description table used by the 
command when executed* 

notes - selects a display of any known problems with 
the command* 

names - selects a display of the command names for a 
utii Ity. 

help - selects a display of the command interface 
description of the command* 

Omission will cause POT to be used* 

outputlo: This parameter specifies the file to which 
information will be displayed* Omission will cause 
SQUTPUT to be used. 

status* See ERROR HANDLING. 

2.16.3 CONVERT.OBJECTJMIE 5 CONOF 

The purpose of this command is to get a NOS/VE object file or 

object library produced on NOS and to convert it to an object 

file suitable for processing by the NOS/VE loader or object code 
maintenance commands. 

convert_ob ject_f i le to«<file reference> 

C fr om*<name>3 
£user«<name>] 
[st atus=<status variable>] 

to * t* This parameter specifies the NOS/VE file name on 
which the converted object file is to be written. 

from ! f« This parameter specifies the name of the NOS file 
to be converted* This is the permanent file name as 
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2*0 COHMAND INTERFACE STATUS 
2*16.2 CQNVERT.08JECT.FIiE I CONOF 

«wi»«>i*»wi*m ************ ** ****** ****** mi**** «*»<*MWMWMM*«MM)«MMi(MMiirwMwwMM»«MWi»wwj»w««*«wwi« 

defined in the NOS file system and can be up to seven 
characters in length. 

Omission will cause the permanent file name of the TO 
parameter to be used. 

user J us This parameter specifies the NOS user 
identification of the owner of the file. This 
parameter is only neccessary if the file is in a 
catalog other than the user who was specified by the 
most recently issued LINK.USER command. 

status? See ERROR HANDLING. 

2.16.3 GET.OBJECT.FILE J GETOF 

The purpose of this command is to get a previously converted 
NOS/VE object file from the NOS side and sets the appropriate 
file attributes that will allow the object file to be used by 
NOS/VE. 

get.ob ject.fi le to*<file reference> 

tfrom*<name>J 
tuser*<name>3 
£password-<string>3 
Estatus-<status varlable>l 

to * ts This parameter specifies the NOS/VE file name of the 
object f i le. 

from \ fi This parameter specifies the NOS file name of the 

object file. This Is the permanent file name as 

defined in NOS and can be up to seven characters in 
I ength. 

Omission will cause the permanent file name of the TO 
parameter to be used. 

user » us This parameter specifies the NOS user 
identification of the owner of the file* This 
parameter is only necessary If the file is in a catalog 
other than the user who was specified by the most 
recently issued LINK. USER command. 

status* See ERROR HANDLING. 
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2.0 COMNANO INTERFACE STATUS 
2.16.4 GET.QBJECT.LIBRARY J GETOL 



2.16.4 GET_0BJECT_LI8RARY ? GETOL 



The purpose of this command is to get a previously created 

NOS/VE object library from the NOS side and set the appropriate 

file attributes that will allow the object library to be used on 
NGS/VE. 

get.ob ject_l ibrary to»<file reference> 

Cf roi=<naie>l 
tuser*<name>l 
t status«<status varlable>3 

to J ts This parameter specifies the NOS/VE file name of the 
object I ibr ar y. 

from If! This parameter specifies the NOS file name of the 

object file. This is the permanent file name as 

defined in NOS and can be up to seven characters in 
length. 

Omission will cause the permanent file name of the TO 
parameter to be used. 

user » us This parameter specifies the NOS user 
identification of the owner of the file. This 
parameter is only necessary if the file is in a catalog 
other than the user who was specified on the most 
recently issued LINK. USER command. 

status: See ERROR HANDLING. 



2.16.5 DISPLAY_OBJECT_TEXT ! DISOT 



The purpose of this command is to produce a formatted display 
of the object text contained in an object file or object library 
produced on NOS/VE. 

displ ay_object_text f i I e*<f i le> 

toutput*<f 1 1 e referenced 
tstatus*<status variable>3 

file ? ft This parameter specifies the object file or object 
library containing the object text to be listed. 

output ! o* This parameter specifies the file to which the 
display is to be written. 
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2.0 COMMAND INTERFACE STATUS 

Omission Kill cause the file SOUTPUT to fee used* 
status* See ERROR HANDLING* 

2.16.6 CITQII 



This command performs the same function as the 
CONVERT_OBJECT_FILE command and will be removed in the next 
build. Users are urged to use CGNVERT_08JECT_FILE instead. 

The purpose of this command is to get a CI object file or 

object library from NOS and to convert it to an II object file 

suitable for processing by the NOS/VE loader and/or object 
library generator* 

citoii ci*<N0S file name> 
Ei l*<NOS/VE lfn>3 
Cuser»<N0S user name>3 
€status»<status variable>] 

ci: This parameter specifies the NOS permanent file name of 
the CI object file or object library to be converted. 

lis This parameter specifies the NOS/VE file name on which 
the converted (i.e. II) object file is to be written. 

Omission will cause the CI file name to be used* 

user* This parameter specifies the NOS user name in whose 
catalog the CI object f i le is located* 

Omission will cause the user name of the user issuing 
the command to be used. 

status: See ERROR HANDLING. 

2.16*7 EDITJFILEJEDITF 

The purpose of EDIT. FILE Is to initiate the execution of the 
SCU editor on text file. (For details see ARH3883.) 

edi t.f i I esedi tf - edit lines on a source file, 
(procedure file not necessarily In its final form) 
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2.0 COHNAN0 INTERFACE STATUS 
2,16. 7 EDIT_FILE*EDITF 



file*?! le{ source ) 
Cresul t=f i I e{ source) 1 
Clnput*file reference 3 
toutput-file reference! 
[status] 



defaults 

SREQUIRED 
$VALUE(FIL£) 
$CQMMAND_OF_CALLE 
SGUTPUT 



2.16.8 JEDIT 



The purpose of this command is to initiate execution of the 
JEDI editor built by Jack Bohnhoff. Anyone wanting information 
about the editor should contact Jack. 

jedit from*<flle> 

tstatus*<s tatus variable>3 

from 5 ft This parameter specifies the file to be editted. 
This file Is rewritten after the editor terminates. 

status* See ERROR HANDLING in the NOS/VE Command Interface. 



2.16.9 DEBUG 



The prototype Rl NOS/VE debugger Is now available. Details on 
how to use the debugger can be found in the "CYBER 180 
INTERACTIVE DEBUG External Reference Specification and User f s 
Guide"* Sunnyvale DCS number SA028. 



2.16.10 OBJLIST 



This command performs the same function as the 
DISPLAY_QBJECT_TEXT command and will be removed in the next 
build. Users are urged to use DISPLAY_QBJECT_TEXT instead. 

The purpose of this command is to produce a formatted listing 
of an object file or object library produced on NOS/VE (i.e. II 
object text). 

objlist object»<lfn> 
C1lst-<lfn>3 
Cstatus»<status variable>l 

object I o: This parameter specifies the object file or 
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2*0 COMMAND INTERFACE STATUS 
2. 16*10 GBJLIST 



object library to be listed* 

list * I? This parameter specifies the file on which the 
formatted listing is to be written. 

Omission will cause the listing to be printed on the 
local printer. 

status: See ERROR HANDLING* 

2.16.11 LINK.USER ! LIU 

The LINK_USER command Is the same as documented in the NOS/VE 
command interface with the exception that the alias LIU is 
supported in the current system and the CHARGE and PROJECT 
parameters are optional tand in fact not useful in the current 
environment since we disable that feature on the NOS side). 

2.16.12 JMROUTE 



This command is an interim implementation of the final ROUTE 
command. for printing files* users should use the PRINT 
procedure now available as the JMROUTE command will be withdrawn 
in subsequent builds. 

JMROUTE, jobname,fi I ename* PR»NVE 

jobname - name that the print file will have In the NQS/VE 
output queue. 

filename - name of the local NOS/VE file created by BAM that 
is to be printed. 

PR - specifies that the file Is a print file Imust always be 
PR). 

NVE - name of the NOS/VE family for the print file (must 
always be NVE)* 

Example of JMROUTE commands 

JMROUTE, LISTING, LINKMAP, PR , NVE 
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3»0 PROGRAM INTERFACE STATUS 



3.0 EEQ£SA1L.IMI£EEA£E-£IAIUS 



The •status 1 column indicates whether the procedure is 
unchanged from the previous build* modified from the previous 
build or not available in this build» Footnotes are numbered 
within each section* 



3.1 _£Q2!1 Aan-EEGCESSISS 



CLP$SCAN_PARA?1_II$T 

CtP$TEST_PARANETER 

CIP$6ETJ<EYW0RD 

CLP$GET_SET_COUNT 

CLP$GET_VALUE_COUNT 

CIP$TE5T_RANGE 

CLPSGET.VALUE 

CIP$D£CLARE_VARIABIE 

CLP$REH0VE_VARIA8LE 

CLPSREAD.VARIABtE 

CLPSWRITE. VARIABLE 

CLP$SCAN_COMMAND_FUE 

CLP$END_SCAN_COHHAND_FIL£ 

CLPSSCAN.COMMANO.LINE 

CLP$CREATE_F RECONNECT IGN 

CtP$DELETE..F RECONNECT ION 

CLP$PUSH/POP_UTILITY 

CLP$GET_CGHMAND_ORIGIN 

CLP$GET_DATA_UNE 

CLP$SCAN_PROC_DECLARATION 



SiJiiiS 



uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 



nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 



3.2 _MS£A££-££MRAXQE 



£r.fi££dux£- 

QSP$FORMAT_MESSAGE 
0SP$SET_STATUS_A8N0RNAL 
OSP$APPEND_STATUS_PARAHETER 
OSP$APPEND_STATUS..INTEGER 



updated - *1 
unchanged 
unchanged 
unchanged 
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3.G PROGRAM INTERFACE STATUS 
3.2 MESSAGE GENERATOR 



*1 Formatted messages are now produced and a "current message 
level" option is supported* 



3 . 3 _R£SQU&£E_MMA££M£t!I 



ELfififixiuLfi. Status 

RMP$REQUEST_MASS_STORAGE unchanged 

RMP$REQUEST_TERMINAL unchanged 

Ait terminal attributes can be specified on the 
RMP$REQUEST_TERMXNAl call but only the following are 
operational s 

o auto_input 

o tr ansparent_roode 

o pro«pt_f i I e 

o prompt_str ing 

Files assigned to a terminal device can be accessed via the 
following BAM requests: 

o AMP$0PEN 

o AMP$GET_NEXT 

o AMP$GET_DIRECT 

o AMP$GET_PARTIAl 

o AMPSPUT.NEXT 

o AMPSPUT.OIRECT 

O AMP$PUT_PARTIAL 

o AHPSCLOSE 



3.4 -EEaS&Aa_EX££UIIQM 



Etfififiducfi- Status. 

PMP$EXIT unchanged 

PMPSEXECUTE changed program 

description 

PMPSTERMINATE unchanged 

PMP$AWAIT_TASK_T£RMINATIQN unchanged 

PMP$M0DULE_TA81E_ADDRESS unchanged 

PMP$ENTRY_PQINT_TABLE_ADDRESS unchanged 

PMP$PUSH_TASK_DEBUG_MODE unchanged 

PMP$SET_TASK_DEBUG_MODE unchanged 

PMP$TASK_DEBUG_MaDE.ON unchanged 
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3.0 PRQGRAH INTERFACE STATUS 
3.4 PROGRAM EXECUTION 



PMP$SET_DEBUS_RING 
PHP$DE8UG_RING 

PNP$CHANG£_DE8UG_UBRARY_LIST 
PHP$ P0P_TASK_DE8UG_HGDE 



unchanged 
unchanged 
unchanged 
unchanged 



3.5 JfcEaS&Ail-SQMfiUBXCAIISii 



££fi£fidii££_ 

0SP$AWAIT_ACTIVITY_CGHPtETION 

PMP$DEFINE_QUEUE 

PMP$RENOVE_QUEUE 

PHP$CONN£CT_QUEUE 

PHP$DISCONNECT_QUEUE 

PNP$SEND_TO_QUEUE 

PMP$RECEIVE_FRQM_QUEUE 

PHP$STATUS.QUEUE 

PNP$STATUS_QUEUES_DE FINED 

PMPSGET^QUEUE.LIHITS 



SlJliiS 



unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 



anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 



3.6 .CiWaiII!H!-£RQt£Sil!ifi 



Ecaafiiiiiiifi- Status 

PMPSESTABLISH.CONDITION^HANDLER unchanged 

PMP$DISESTABtISH_CQND_HANDLER unchanged 

PMP$CAUSE_CGNDITION unchanged 

PMP$CONTINUE_TO_CAUSE unchanged 

PNPSTEST.CONDIT ION. HANDLER unchanged 

PNP$VALIDATE_PREVIOUS,.SAVE_AREA unchanged 

PMPSESTABLISH^DEBUG.CFF unchanged 

OSPSSET.STATUS.FRQN.CONDITION unchanged 



3.7 -.£RaaaAa-5£R^xc£S 



££flfifidULfi- 

PNP$GENERATE.UNIQUE.NAHE 

PNP$GET_TIME 

PMP$GET_MICROSECGND_CLQCK 

PMP$GET_TASK_CP..TIHE 

PMPSGET.DATE 

PMP$GET_USER_IDENTIFICATON 



Status 

unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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3.0 PROGRAM INTERFACE STATUS 
3.7 PROGRAM SERVICES 



PMP$GET_ACCOUNT_PROJECT 

PMP$GET_JOB_NAMES 

PMP$GET_J0B_1D 

PMP$GET_JOB_MODE 

PMP$GET_PROGRAM 

PMP$GET_TASK_ID 

PMP$MANAGE_SENSE_ SWITCHES 

PMP$GET_OS.VERSION 

PMP$GET_PROCESSOR_ATTRIBUTES 

PMP$DEFIN£_DEBUG_ENTRY 

PMP$GET_DEBUG_ENTRY 

PMP$MODIFY_DEBUG_ENTRY 

PMP$R£MOVE_DEBUG_ENTRY 



unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 



anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 



3.8 JJlS&Iiifi 



PMP$L0G 
PMP$L0G_ASCII 



Status 

unchanged 
unchanged 



3.9 «£IU.MMAfiIH£tiI 



£££££*&££_ 

Sequential Access 
Byte. Addressable Access 
Record Access 
Segment Access 
V_Systera Specified 
V.User Specified 
U_System Specified 
U.User Specified 
F_System Specified 
F_User Specified 

AMPSOESCRIBE.NEW.FILE 

AMPSFIIE 

AMP$GET_FILE_ATTRIBUTES 

AMP$FETCH 

AMPSSTQRE 

AMP$CQPY_FILE 

AMP$RENAME 

AMPSRETURN.LQCAL.FILE 

AMPSOPEN 



SJtaiys 



unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 

unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 



anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 

anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 



- *1 



- *4 
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3.0 PROGRAM INTERFACE STATUS 
3.9 FILE MANAGEMENT 



*l 



*2 



*3 



*4 



AMP$CLOSE 

ANP$FETCH_ACCESS_INFORMATiaN 

AMPSSKIP 

AMPSREWIND 

AMP$WRITE_END_PARTITIQN 

AMP$GET_NE*T 

AMP$GET_DIRECT 

AMP$GET_PARTIAL 

AMP$PUT„NEXT 

AMP$PUT_DIRECT 

AMP$PUT_PARTIAL 

AMP$SEEK_DIRECT 

AMP$GET_SEGMENT_ POINTER 

AMP$SET_S£GMENT_EQI 

AMP$SET_SEGMENT_POSITION 

AMP$SET_LOCAL_NAME_ ABNORMAL 

AMPSSET.FILE. INSTANCE. ABNORMAL 

AMP$ACC£SS_ METHOD 

AMP$F ETC H_F APPOINT ER 

AMP$STORE_FAP_POINTER 



unchanged 

unchanged 

unchanged 

*2 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged - *3 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 



Segment access 

If a segment access file Is written and an 
AMP$SET_SEGMENT_EOI is not issued to record the EOI* EOI 
remains zero* The highest page referenced is not yet used as 
the default EOI. This particularly affects those who wish to 
make heaps permanent because EOI is always zero for a heap. 



AMPSREWIND 
The WAIT parai 



leter on the procedure call is not supported. 



AMP$PUT_PARTIAL 

PUT.PARTIAL with the TERM.OPTION * 

as a put. next if a preceding START 



AMCSTERMINATE does ap.£ act 
was not issued. 



AMP$GET_FILE_ ATTRIBUTES 

The EXI$TING_FIL£ parameter is not implemented correctly. We 

have a PSR indicating that the value of exi st i ng.f i I e is 

always set to FALSE. However* the code appears to always set 

the value to TRUE. In any case* the value cannot be relied 

upon. 



3.10 .£E&ttAH£tlI-£ILE-aAIUfiEll£liI 



PFPSDEFINE 



Status 
unchanged 
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PFPSATTACH unchanged 

PFPSPURGE unchanged 

PFPSCHANGE unchanged 

PFP$PERMIT unchanged 

PFP$DELETE_PERMIT unchanged 

PFPS0EFINE..CATAIOG unchanged 

PFP$PURGE_CATALOG unchanged 

PFPSP ERMIT_CATA10G unchanged 

PFP$D£LETE_CATALOG_PERMIT unchanged 

Permanent file program interface deficiencies 

1. Permanent fiies on the NOS/VE are only permanent until a 
NQS/VE deadstart. 



3.11 _J!EllQ&X-!iAMASEIl£liI 



MMP$ ADVISE. IN unchanged 

MHP$ADVISEJ3UT unchanged 

MMP$ADVISE_OUT_IN unchanged 

NMP$yRITE_MQDIFIED_PAGES unchanged 

MMP$CREATE_SEGMENT unchanged 

MMPSDELETE.SEGMENT unchanged 

MMP$STQRE_SEGMENT_ ATTRIBUTES unchanged 

MMP$FETCH_SEGMENT_ATTRIBUTES unchanged 

MMPSVERIFY.ACCESS unchanged 

MMPSFREE unchanged 

MMP$LOCK_PAGES number of locked pages per 

MMP$UNLOCK_PAGES segment restricted to 32 

NMP$F£TeH_PVA_UNWRITTENJ>AG£$ unchanged 



3.12 ..iiAiimcs-EAakiii 



SFPSESTABLISH.STATISTIC unchanged 

SFPSENABLE.STATISTIC unchanged 

SFP$DISABLE_STATISTIC unchanged 

SFP$DISESTA8LISH„STATISTIC unchanged 

SFP$EMIT_STATISTIC unchanged 

SFP$EMIT.SYSTEM.STATISTIC unchanged 
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3 a 3 IMIEEACmi-EACILIII 



IFPSTERMINAL unchanged 

IFP$FETCH_TERMINAL unchanged 

IFP$STOR£_TERMINAL unchanged 

IF P$GET_DEFLT_TERMINAL. ATTRIBUTES unchanged 

IFPSGET.TERHINAL. ATTRIBUTES unchanged 



3.14 &QS£¥£-E*£Emaiia 



The following summarizes the exception code ranges currently 
assigned to NQS/VE. These code ranges represent a finer 
breakdown than the one specified in the SIS for interna* MOS/VE 
development purposes. However* it is important to remember that 
only the product identifiers documented in the SIS may appear in 
error messages. 



Common Modules 
Common Code Generator 



Exception Code 

1 - 158,999 
159,000 - 159,999 
160,000 ■-■ 169,999 



160,000 
164,000 
165,000 
166,000 
167,000 
170,000 - 
180,000 — 
190,000 — 
200,000 - 
200,000 



163,999 
164,999 
165,999 
166,999 
- 167999 

179,999 

189,999 

199,999 

209,999 

204,999 



205,000 - 205,999 
210,000 - 219,999 



210,000 
211,000 
212,000 
213,000 
214,000 
215,000 
216,000 
217,000 



210,999 
211,999 
212,999 
213,999 
214,999 
215,999 
216,999 
217,999 



9,000 - 9,999 
8,000 - 8,999 



Product 
Identi f ier 

Reserved 
SY 

AH 
8A 
LN 
JF 
SR 
CM 
CL 
JM 
LL 
MM 
MM 
MM 
OS 
OS 
MT 
10 
10 
DM 
ML 
IF 
TM 



Product Name 



System Core 

Basic Access Methods 

Basic Access 

Local Name Mgr 

Job File Mgr 

Conversion Services 

Configuration Mgmt 

Command Language 

Job Management 

Loader 

Memory Management 

Monitor Level 

Task Level 

Operating System 

OS 

EXEC 

MS I/O 

Tape I/O 

Device Management 

Memory Link 

Interactive 

TM Monitor 
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218*000 - 218*999 
219*000 - 219*999 
220*000 - 229*999 
221*000 - 221*999 
222*000 - 222*999 



230*000 
240*000 
250*000 
260*000 
270*000 
280*000 
290*000 
300*000 
310*000 
320*000 
340*000 
330*000 
500*000 
510*000 
520*000 
530*000 
540*000 
550*000 
560*000 
570*000 
580*000 
590*000 
600*000 
610*000 
620*000 
640*000 



239*999 
249*999 
259*999 
269*999 
279*999 
289*999 
299*999 
309*999 
319*999 
329*999 
349*999 
339*999 
509* 999 
519*999 
529*999 
539*999 
549*999 
559*999 
569*999 
579*999 
589*999 
599*999 
609*999 
619*999 
629*999 
649*999 



TM TM Task 

JS Job Swappers 

PF Permanent File Management 

ST Set Management 

PU Permanent File Utilities 

PH Program Management 

RM Resource Management 

OF Operator Facility 

AV User Administrator 

IC Interstate Communication 

RH Remote Host Facility 

OC Object Code Utilities 

D8 Oeadstar t/Recover y 

MS Maintenance Services 

Reserved 

SF Statistics Fac« 

US User Errors 

AA Advanced Access Method 

AG ALGOL 

AL Assembly Language 

AP APL 

8A BASIC 

CA Conversion Aids System 

CB C080L 

CY CYBIL 

FT FORTRAN 

PA PASCAL (Wirth) 

PI PL/1 

SM Sort Merge 

SC Source Code Utility 

OB Debug 
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4 . aUAUSIAI£-££A0SIA£I-48fi-Q££EAII0fci 



4 . 1 CUBE£8I-aiiAL-SIAI£-£0&EI£UB AIIQtl 

The Arden Hills S2 development systems are configured to run 
with three FMD units* 

o FHD Unit 43 

This unit contains the following: 

- A170 NOS <5.3 as released)* CTI> CMS£» EI binaries* NOS 
deadstart files 

- Files associated with user name LIBRARY 

- Flies associated with user name SES 

- Files associated with DEVI* 0EV2* REL1* INT1. 

o FMD Unit 41 

This is a scratch unit* This unit can be initialized* if 
there is a system error during deadstart* by adding the 
following lines to the CMR decks 
INITIALIZE. 1#AL. 

GO. 

o FMO Unit 42 

This unit contains the following: 

- NOS/VE Development Area PL»s and flember PL's 

- NOS/VE Deadstart Files to be tested (saved in individual 
user's catalogs) 

- Files associated with user name INT2 

4.2 aS£&_HAE£S-Aaa-EE&aAM£tiI-EIL££ 

1) The convention used for creating user names on NOS/VE is as 
follows: 

o Your user name will be your Initials. 
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o Vour password will be these 3 letters followed by the 

letter •*»• 
o fou must see CONSOURCE (R.K* Cooper - x3092l to be 

assigned a user Index 

2) PF dumping and loading 

You may use H S£S .DUMPPF W on SN/101 to dump your permanent 
fies to tape* and then load them onto your user name on A17C 
NOS using "SES.LOADPF". Documentation on how to use these 
SES procedures and what their parameters are is included in 
the SES User*s Guide* or they can be obtained by typings 

SES»HELP.DUMPPF and SES*HELP.LOADPF. 

The following commands need to be entered from deadstart 

o Set deadstart panel to deadstart from unit 43 

o Push D/S button 

o Select H M W display 

o Type in "6. 20* 

o Carriage return 

o Type in H CW MA8 2 W carriage return wait until LOADED 

o Then redeadstart as described in the next section 

*** UZ£.ga£J2£A2SX&EI 

o Set the D/S panel to deadstart from the primary system disk. 
This is Unit 43 for all Build P systems. 

o Push D/S button 

o Select *0 M display 

o Select "H" display 

o Enter CM-10000 

o Enter CCR) 

o Enter date/time 

Walt for deadstart to complete. 

Note* The deadstart tape DUAL6P (which is currently installed on 
unit 43) is found in the area in the northeast corner of the room 
where the tape cabinet is found. 
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*. 5 8QSZ¥£ J}EMmEI-Ma.IMmLUIII2£i 

o The following file must be available in your catalog on the 
S2J 

TPXXXK contains a NOS/VE deadstart image. This must be a copy 
of the dual state deadstart images available from the link 
procedures. 

o Bring up dual states 

X.UPNYVE «CAT«mycat. 0EVl*scat) 

where mycat « user catalog (as before) 

scat * system catalog - INT2# INT1# DEVI or DEV2 

NOS/VE is currently generated and initialized on both NOS and 
N0S/VE# Ail source and object libraries that make up the NOS/VE 
system are produced on NOS and therefore must be converted from 
their CI to II counterparts* Other parts of installing and 
Initializing the system <e*g* building the SSYSTEN catalogue) 
are performed by command language procedures on NOS/VE* Since 
the same system wilt be deadstarted many times in a closed shop 
environment* it is advantageous to only perform the conversion 
from CI to II a single time; save the results in the NOS file 
system and then simply bring the files back during deadstart* 

The actual files that get Installed and loaded on each 
deadstart are determined by a command language procedure (the 
system profile) Interpreted on NOS/VE* This procedure can be 
modified by each site to initialize their NOS/VE environment in 
the most suitable fashion* The process of building the system 
profile and of performing the CI to II conversions is referred to 
as an installation deadstart and the process of executing the 
system profile and of fetching previously converted files from 
NOS and making them available in the NOS/VE file system is 
referred to as a deadstart* A single command Is available to 
perform both an installation deadstart and a deadstart* 

4*5.1 DS 

The purpose of this command is to perform an installation 
deadstart or a deadstart of NOS/VE. 

ds Ci nstal 1 *<bool ean>3 

Cget_source_! Ibr ar les*<bool ean>1 

Cget_products*<boolean>1 

Cecho»<boolean>3 
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Cal ter n at e. use r * <NGS. use r_n am e> 3 
Csave.instalt.fi I es«<bool ean>l 
Cval idate.users*<bool ean>3 
Cdebug*<boolean>1 
Chelp»<fite referenced 
Cstatus*<status variabte>1 

install J Is This parameter specifies whether an 
install ation deadstart is to be performed. Valid 
specifications ares 
TRUE - installation deadstart to be performed* The 

system libraries (CYBILIB* SYSLIB* etc.) are 

built from CI object files. 
FALSE - deadstart to be performed. The system 

libraries are obtained from the results of a 

previous installation deadstart. 

Omission villi cause a deadstart to be performed. 

get.source.l ibr ar i es * gsls This parameter specifies whether 
SCU libraries are to be installed. Valid 
specifications ares 
TRUE - libraries are installed 
FALSE - libraries are not installed 

On the Arden Hills closed shop S2 system* the SCU 

libraries to be installed ares 

OSLPI - operating system program interface 
Subset of NOSVEPL - operating system source 
I ibr ary 

Omission will cause SCU libraries to be installed. 

get. products * gps This parameter specifies whether the 
object libraries defining the current product set are 
to be installed. Valid specifications ares 
TRUE - the products are installed 
FALSE - the products are not installed 

On the Arden Hills closed shop S2 system* the product 
set to be installed consists ofs 

CYSIL 

SCU 

JEDIT 

BANNER 

Omission will cause the product set to be installed, 
echo * es This parameter specifies whether the commands 

Build ? 9 November 1981 



4-5 
NOS/VE Build l» helpful hints 

4.0 DUAL STATE DEADSTART AND OPERATION 

should be echoed to the console during execution. 

Valid specifications ares 

TRUE - echo commands 

FALSE - do not echo commands 

Omission Mill cause commands not to be echoed. 

al ternate_user ! aus This parameter specifies Nhat NOS user 
to check If the default NVE user does not have the 
needed file. Any NOS user name is allowed. 

Omission will cause INT1 to be used. 

save_instal l_f I I es * slfs This parameter specifies whether 
to save the system libraries created by an installation 
deadstart. This parameter is ignored for a normal 
deadstart. Valid specifications ares 
TRUE - save the installed system libraries 
FALSE - do not save the installed system libraries 

Omission will cause the files not to be saved. 

val I date_users " vus This parameter specifies whether to run 
the job that validates NOS/VE users. Valid 
specifications ares 
TRUE - run the validation job 
FALSE - do not run the validation job 

Omission will cause the validation job to be run. 

debug * ds This parameter specifies whether the procedure 
should abort if an error condition is detected. Valid 
specifications ares 
TRUE - do not abort on an error 
FALSE - abort on an error 

Omission will cause the procedure to abort when an 
error is encountered. 

help * hs This parameter specifies whether help information 
is to be written. If this parameter is specified* the 
help Information will be written to the specified file 
and the procedure will terminate. 

Omission will cause the procedure to execute and the 
help Information not to be written. 

statuss See ERROR HANDLING in the NOS/VE ERS. 
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If you change any of the following decks you MUST use the 
Installation deadstart from your own catalog (with files CYBILGOj 
XLJCQL* XLJQSL* and XLJLI8)> or you must use the a I ternate_user 
parameter to specify a NOS catalog containing the files (e.g. 
DEVI). 



AMMTSA 

IFMEXEC 

OCMSDL 

QCMGLG 

QCMCQM 

RHMQTE 

RHMWLf 



BAMDVR 

IIMA72H 

OCMEND 

OCMCOL 

OCHSAT 

RHMLCF 

RHMRTN 



8AMPC4 

IIMTDEL 

OCMLP 

QCMQ8J 

RHMQAF 



BAMPC2 
IIMRUSM 
OCMCPY 
OCMCHA 

RHMLOG 
RHMGDM 



8AMPC1 

IIMQC2S 

OCMCRM 

OCHQFH 

RHMQIP 

USORT 



8AMPC3 
OCMREO 
OCMGEN 
OCMADD 
RHMSFM 
RHMQRE 
UUSER1 



MMRSE 

GCMMUR 

QCMMOMS 

OCMNP 

RHMLGF 

RHMA12 

UUTL 



IIMRLE 
OCHBIH 
OCMDEF 
OCHDEt 
RHMMLI 
RHM12A 



IIHRUN 

OCMREP 
QCMDLB 
RHMQOP 
RHMRQU 



4.5.2 EXAMPLE OF NOS/VE INSTALLATION OEAOSTART 



Type 

K>n. where n is the UPMYVE control point number. 

K.LIU (your un#NVE) your. password. 

K.GETF OS. 

K.DS TRUE FALSE FALSE AL=scat. 

The system is up when the following message comes ups 

Oeadstart Completed 

Ready for commands 



4.5.3 EXAMPLE OF NOS/VE DEADSTART 



The Integration system has had the installation deadstart run on 
It. Also the files produced by the installation deadstart have 
been made semi-private and are found on the catalog used in the 
UPMYVE call. 

Type (where DEVI Is the same as the CAT*value in the UPMYVE 

call)? 

K*n. where n is the UPMYVE control point number. 

K.LIU (DEV1*NVEJ DEV1X. 

K.GETF OS. 

K.DS. 

The system is up when the following message comes up: 

Oeadstart Completed 

— — Ready for commands 
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4.5.4 EXAMPLE OF MINIMAL NOS/VE DEADSTART 



The minimal deadstart shown below may be useful to OS 
developers who need to get the system up quickly and do not nee4 
the product set or validated users. Note that if a job (batch or 
Interactive) is to be run it will have to be run under user JAN. 

Type 

K*n. where n is the UPMYVE control point number. 

K.LIU (your un»NVE) your_passwor d. 

K.GETF OS U«scat. 

K.DS#>N0 NO VU*N0 AU»scat. 

This deadstart takes a little less than two minutes. 
The system is up when the following message comes up: 

Deadstart Completed 

— - Ready for commands 



4 . 6 ^QS£^£-ItiI£EACII^£^£ACIlIII.Q££MIIQiS 

4.6.1 OPERATOR INITIATION 

To bring up the NOS/VE interactive facility do the following: 

1) Bring up NOS/VE. 

2) Bring up NAM 

At the system console enter: 
3.NAMS2. 

3) If IAF is not up at control point It enter: 
IAF. 

4) Bring up A170 part of interactive: 

- TAFNVE. 

Control point three must be free or rolloutable (i.e. NAM should 
not be there). This also brings up PASSON and the MLI subsystem 
control points. 
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4.6.2 OPERATOR TERMINATION 

To terminate NOS/VE Interactive any of the following may be 
done* 

- 3.CF0.DI* AP=TAF. 13 is the NAM control point number) 

This is the preferred method. To bring NOS/VE interactive 
back up* you must first do a 3.CF0.EN* AP*TAF. 

3.CF0.DI.NE. 13 is the NAM control point number) 

This terminates the entire network including IAF*R8F# etc. 

4.6.3 OTHER OPERATOR CAPABILITIES 

To logically turn the printer ©n# under DSO enters 
0N32. 
FQRM32>TM. 

- To send a "shutdown warning" to all terminals logged on to TAF 
do s 

3.CF0.ID* AP=TAF. (3 is the NAM control point number) 

- To send a message to all terminals do* 

3.CF0.MSG* ALL*mesage, (3 is the NAM control point number) 

- PASSON has the ability to record various types of diagnostic 
information. This capability is controlled via the sense 
switches at the PASSON control point* To turn a sense switch 
on (off) at control point N dos 

N.ONSWX. (N.OFFSWX. ) 

Where X Is the desired sense switch <1 to 6). The PASSON 
default is all sense switches off. It will take a short 
period of time before PASSON detects a change in a sense 
switch and reacts to it. The sense switches currently used by 
PASSON are: 

1 Network Trace 
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2 PASSQN Logic Trace To Dayfile 

3 Memory Link Trace To Oayflle 

* . 7 aQui£.Ati.iii£yi«£ii£-£sai3-aiz^io^ciaa 

Through the system console* enters 

Type 

X.OIS. 

USER»A,8. 

GET*f i lename. 

where filename identifies the input file to be routed. 

ROUTE* f ilename»DC*LPtFC*RH. 

*.8 &_flIi£UX-ASCII 



Support of 6-12 ASCII from the console (K display) causes the 
following changes: 

I8£UI- IRA!i£LAI£J2-IQ.. I^EUI- IRA&SLAIfca.IQ 



/l 


A 


/( 






C 




/2 


w 


/) 






1 




/3 


# 


/♦ 






> 




/4 


$ 


/- 






< 




/5 


(reversed /I 


/« 






. 




/6 


• 


/* 






f 


(single quote) 


/7 


• 


// 






/ 




/8 


C 


/> 






: 




/9 


> 


/A 


to 


/Z 


a 


- z (lower cas 


/O 


_ (underscore) 













(The major Incompatibilities with earlier systems are for 
characters for ; and f . To get a semicolon* type /6# to get 
a • (single quote)* type /* 



4.9 QiM_IMEQKflAIIQU 

To create an Express Deadstart Dump (EDD) tapes 
1) Mount scratch tape (ring in) on a 9-track drive. 
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2) Push 0/S button. 

3) Select U (utilities) display. 

4) Select E (EDO) display. 

5) Set channel ($2*13). 

6) Set ECUU (S2«01uu) 

£ * equi pment 

C « 1 for 67X drives 
2 for 66X drives 

uu * unit number of the tape drive to be used. 

7) Answer **non zero inhibits rewind* 1 with a CR* 
81 Answer "dump number* 1 with a CR» 

9) Answer "dump control ware** with a CR* 

* - Warning if this step is omitted* DSDI canot process 
the dump tape. 

To create a listing of the EDD tape? 

1) REQUEST* DUMP, NT* D*PE*F«$#IB«KU* P0*R» VSN* your choice. 

2) GET*DSDI/UN«DEV1. <On S/N 101.1 

or 
GET#DSDI/UN»DEV1. (On S2. ) 

3) Create DSDI direct! ves file: 

A DSDI directive file should Include the following: 

IOUMR. 

PROMR. 

MEMMR. 

PRORF. 

W» f i rst_byte_address» I ast_byte_adress* asi d. (where the 

f lrst_byte_address and I ast.by te_address are hex byte 

addresses and asid is the as i d of the segment to be 

dumped) 
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4) Execute DSDI: 

RFU60000* 

DSDI»M#D>I»*input directives file", 

5) To run (after the first time)* 
OSDI*I*n« 

<Does not read tape again.) 

6) To run Interactively: 

Same as above* except to do W command must first do: 

OUTPimUSTFIL 

71 C170 OSOI information can be found in Chapter 10 of the 
NOS SYSTEM MAINTENANCE Manual. 

A170 OSOI Info can be found in document ARH3060 — GID 
for A170 N0S/S2. 

*.10 MOSi:¥E_I£EfliaAII0i!! 

o Bringing down dual state: 

K.*BYEVE. 

o If not a normal termination 

K.*RUN. 

K.tENDLST. 

K.*ENDRUN. 

Before leaving the machine* it is necessary to bring NOS 
down. If NOS has crashed* a level 3 deadstart must be attempted 
even if the only reason is to bring NOS down. To bring NOS down* 
do the following: 

I) Enter: 

CHE 
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The screen will display* 
CHECKPOINT SYSTEH. 
Enters carriage return 

2) Hake sure no mass storage device has a checkpoint rquested. 
To do this* enters £»N. If the display shows there are no 
"C"s In the status field* then all devices are checkpointed 
and you may continue* 

3) Enters 
STEP. 

41 Push deadstart button. 
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5.0 mi£B-£0£E-££aU££££ 



The System Core debugger provides a set of capabilities 
intended to assist in debugging the operating system* Services 
provided by the debugger are task orlenteds selection of the 
tasks to be debugged must be made via debugger subcommands* No 
tasks will be under control of the debugger unless they are 
selected* The selection capability allows any number of tasks to 
be debugged simultaneously; from one task to all tasks in the 
system. Obviously a capability this powerful must be used with 
some care. The System Core debugger uses the debug hardware to 
provide these capabilities. 



5.1 SXSQEfiUS 

The purpose of this command is to initiate execution of the 
system core debugger. This command can be issued from the 
deadstart command file or as a command in any job. 

sysdebug 

This command has no parameters! all information the debugger 
requires is provided via subcommands. 



5 • 2 SUacaHMti&-£A£A!3£IE£-QE£I!im£mS 



<name> it* 1-8 character breakpoint name 

<condition> st* READ! WRITE J RNI S BRANCH5CALL S-DIVFLT. ARLOS J 

AROVFUEXQVFUEXUNFUFPLOSJFPINDEFJINVBDP 
<base> n* process virtual address 
<offset> s:« integer 
<length> ?J* integer 
<frame> *** 1..100 
<count> ss» 1..100 
<regid> it* XJAJP 
<regno> n» 0..15!0..0F<16) 
<he x„vstr ing> si* f bex string 1 
<tlme> ii« l..(2**31)-l 
<vstring> :s* •charstring' 
<datatype> :t* HEX J ASCII ! ASCSDEC 
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<selector> n* FULL i AUTOJSAVE 

5*3 mi£££_CQ££ J2£SUS££R-SU££Gl$Mi!ieS 

Within the descriptions which follow* optional parameters are 
enclosed in brackets* Default values for optional parameters are 
also defined* 

5*3.1 SELECT 



The purpose of this subcommand is to select the tasks in which 
the system core debugger is to be active* When the debugger is 
first called* It is not active in any task* To use the debugger 
therefore* it is necessary to select the tasks in which it is to 
beacti ve. 

select <selectlon option> Krlng number> I <active job list 
ordinal>3 

sel ect i on.optlon: This parameter specifies one of a series 
of selection options used to control the tasks in which 
the debugger will be active and some other debug 
options* The selections are remain in effect until 
they are explicitly changed with subsequent SELECT 
subcommands* Valid selection options are: 

<right?left> - This selects the screen for the debug 
display* The display stays active when the screen is 
swi tched* 

< jobmoni tor Jno jobmoni tor> - This selects whether or not 
to debug job monitor tasks* 

<user ?nouser> - This selects whether or not to debug 
user tasks (i.e* those that are not job 
monl tors )• 

<hlghrlng> - This specifies the highest ring in which 
debug traps will be recognized* Traps occurring 
in rings above this selection will be ignored* 

<job«nojob> - This enables or disables debugging for 
the job at the specified active job list ordinal* 
The system job has an active job list ordinal of 
zero* 
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5.3.1 SELECT 



<al I jobs1nojobs> - This activates or deactivates 
debugging in all jobs. 

The initial selections ares RIGHT* NGSTEP* 
NOifOBMONITOR* NOUSER* HIGHRING^O* NOJOBS. 



5.3.2 BREAKPOINT 1 B 



The purpose of this subcommand is to selects a program 
Interrupt which is to occur upon occurrence of a specified 
condition within a specified virtual address range. 

breakpoint <name> <conditlon> t<base>l £<offset>] t<length>3 

The <name> is any user supplied name for identifying the 
breakpoint. A maximum of thirty two breakpoints can be 
selected. When a trap occurs* the <name> of the breakpoint which 
caused the trap is displayed. 

The base parameter is required when specifying a new 
breakpoint name; offset and length specifications are optional in 
this case. When adding a new condition selection to an existing 
breakpoint* base* offset* and length parameters may not be 
spec! fled. 

Base* offset* and length parameters define the desired virtual 
address ranges <base> + <offset> yields a first-byte-address; 
f Irst-byte-address + <length> -1 yields a last byte address. 

Default parameter values: 

<offset>? 
<length>s 1 

5.3.3 REMQVE_8REAKP0INT ! RB 

The purpose of this subcommand is to deselect a previously 
selected program interrupt. 

r emove_br eakpolnt <name> C<condi tion>1 

If only the name parameter is specified* all conditions 
associated with the breakpoint are deselected and all evidence of 
the breakpoint is removed. If the condition parameter is 
specified* only that condition Is deselected; however* If the 
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specified condition is the only condition selected* alt evidence 
of the named breakpoint is removed. 

5.3.* LIST.BREAKPQINT J 18 

The purpose of this subcommand is to provide a list of 
currently selected breakpoints and associated conditions. 

I I st.breakpoint t<name>3 

If the name parameter is specified* information is displayed 
for the named breakpoint only. If the name parameter is not 
specified* information is displayed for all currently defined 
breakpoi nts. 

5.3.5 CHANGE. BREAKPOINT 1 CB 

The purpose of this subcommand is to change the virtual 
address range of a previously specified breakpoint. 

change.br eakpoint <name> <base> £<offset>1 C<length>3 

Base* offset* and length parameters define the desired virtual 
address range: <base> + <offset> yields a f I rs t-byte-address 5 
first-byte-address + <length> -1 yields a last byte address. 

Default parameter values: 

<offset>* 
<length>* 1 

5.3.6 TRACE.8ACK S TB 

The purpose of this subcommand is to provide information 
relevant to stack frames associated with an interrupted procedure 
and its predecessor procedures. This subcommand does not 
currently validate the PVAs in the stack it is tracing* therefore 
access violations may occur if the stack being traced has been 
destroyed. 

Information displayed for each selected stack frame consists 
of J 
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Stack frame number! 
* Current P-address of the associated procedure! 

Virtual address of the start of the stack frame! 
— Virtual address of the stack frame save area. 

trace.back £<frame>l C<count>3 CFULL1 SH0RT3 

The frame parameter specifies the number of the first stack 
frame for which information is to be displayed. Stack frame 
number one Is associated with the interrupted procedure* stack 
frame two is associated with the interrupted procedure's 
predecessor* etc. 

The module name provided on the traceback is usually correct 
but not guaranteed. 

The count parameter specifies the total number of stack frames 
for which information is to be displayed. 

Default parameter values* 

<frame>* 1 
<count>s 1 



5.3.7 OISPLAY.STACK. FRAME J DSF 

The purpose of this subcommand is to display selected 
information from a specified stack frame. 

displ ay.stack^frame t<frame>! C<selector>3 

The frame parameter specifies the number of the stack frame 
for which information Is to be displayed. (Stack frame number 
one is associated with the interrupted procedure* stack frame two 
Is associated with the interrupted procedure's predecessor* 
etc. ) 

The selector parameter identifies a region of the specified 
stack frame? 

AUTO* Causes the automatic region of the stack frame to be 
displ ayed. 

SAVE* Causes the save area of the stack frame to be 
di spl ayed. 

FULL? Causes both the automatic and save areas of the stack 
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frame to be displayed* 

Oefault parameter values: 

<frame>s 1 
<selector>J FULL 

5.3.8 DISPLAY_REGISTER J OR 

The purpose of this subcommand Is to display the contents of a 
specified register of an interrupted procedure. 

displ ay.register <regid> £<regno>3 C<datatype>] 

Default parameter values* 

<regno>J 
<datatype>* HEX 

5.3.9 DISPLAY.MEMORY I DM 

The purpose of this subcommand is to display the contents of a 
specified area of virtual memory. This subcommand does not 
currently validate the PVA it is displaying* therefore ahrdware 
access violations will occur when attempting to display non 
readable memory. 

displ ay.memory <base> £<length>3 

Oefault parameter values: 

<length>s 8 

5.3.10 CHANGE. MEMORY 5 CM 

The purpose of this subcommand is to set a specified value 
into a specified location of virtual memory. This subcommand 
does not currently validate the PVA It is changing* therefore 
hardware access violations will occur when attempting to change 
nonwrl table memory. 

change_memory <base> <hex_vstr lng> 
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5.3.11 RUN 



The purpose of this subcommand is to Invoke program execution 
after a selected program interrupt has occurred* 

run 
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A standalone deadstart tape is a 9 track* unlabeled I format* 
1600 BPI density tape C produced fey the NVESYS procedure). To 
deadstart in standalone mode* perform the following steps: 

DSet the deadstart panel for standard disc deadstart: 
Ch*l U*V3 

2)Push deadstart button? select H display* 

3)Enter: XYZCcr) 

XYZ is a special standalone deadstart routine* 

4)A copy of a deadstart panel will appear on the screen. It is 
setup for CH*13* U*0* If you want to change any word* just 
type in: 

N»xxxx 
where N Is the word number and xxxx is the octal value* To 
change the unit number* type In: 

5*12u 

where u is your deadstart tape iLiii&icai—ttaii !• When done 

making changes* hit the lfift.klaufc key* 

5)When you are done making changes or if no changes were made* 
hit <crJ* The tape should move and eventually the message 
"PROCEED" will appear on the lower left on the console* 

6) Enter J CR*M2*BR»0000000000000000 

This clears the memory bounds register which is set by 
NOS deadstart* 

7)Enter: DR*P2 

This displays the CPU registers* The SIT should be 
changing; if not* give up* 

8)At this point the system core is loaded and can be patched* 
The commands to display and change memory are documented in 
IPNDOC* 

9)To start the system enter: 
SS 

The CPU registers should spin; if they ever stop the CPU has 

halted* It takes a while to initialize the disc and load the 
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job template* but when or before that is done enters 

DD 
which displays the system dayfile* Commands can now be 
entered* 



Build Pf November 1981 



7-1 
NOS/VE Build P helpful hints 

12/22/81 

7.0 INTERACTIVE PROJECT DUNP ANALYSIS PROCEDURES 



7. IMI£E^CIIM£^£EQl£CI-QUH£.AM4iXaii.EgQmi}y££S 



The following procedures were developed by the interactive 

project to assist them In Interpreting dumps* They guarantee the 

procedures work if your user name is IFP* otherwise caveat 

emptor. For more information about these procedures* contact 
Fred Blschke* 

The following dump analysis procedures are available in the 
IFP catalog: 



7.1 _£aQSIH 

This is a CCL procedure which brings an EDO dump tape on a 
specified VSN into the simulator* The procedure can be accessed 
from the IFP catalog as follows: 

get* eddslm/un*if p 

begin»«edds im*vsn t vsn is the vsn of the EDD dump tape ) 

7*2 _AML£X£ 

This is a Simulator INCLUDE file which does a preliminary 
analysis of the current simulator exchange package ( when the 
system crashes in task services* this will normally be JPS )• A 
qr exc*mon or qr exc*rma can be used to get into another exchange 
package before doing the Include* The include file is 
ANALEXC/UN*IFP* It can be called from the simulator as follows: 

a get* ana! exc/un* i f p f 5 include analexc 

Ccarriage return) a lone carriage return must be entered 
after an INCLUDE In order to start It up 
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7.3 .SISQUME 

This Is a CCt procedure which calls OSDIV to dump a specified 
segment to a list file which can then be examined with an editor 
or printed* The procedure can be accessed from within the 
Simulator as follows: 

* get*segdump/un*if p f ; «beg in* •segdump*seg» I en* f i I e» exc*cpf • 

The segdump parameters are: 

seg - segment number in hex < default is 1 ) 

length - number of bytes to dump in hex ( default is 10000 ) 

list - name of the list file C default is LIST ) 

exc - reference exchange package C default is JPS ) 

cpf - name of checkpoint file C default is CPE ) 

In most cases of task services debugging* only the seg 
parameter is needed* 

7.4 _AM&uaa 

This Is a CCL procedure which uses DSDIV* XEDIT and the 
Simulator to perform an analysis of all tasks in a specified 
job* The procedure can be accessed from within the simulator as 
f ol lows: 

•get*ana! job/unMf p* > f beg in* »ana I job»seg*cpf f 

The analjob parameters are: 

seg - the monitor segment which contains the exchange 
packages of the job ( 14 is the system job» 15 is job 1 
etc* I ( default is 14 ) 

cpf - the name of the simulator file ( default is CPF ) 

After the procedure has completed* a list of the RMA's of the 
job's exchange packages can be obtained by doing the following: 

i ncl ude tpl ist 
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(carriage return) 

A tracebaek of all tasks in the job can be obtained by doing 
the following* 

include tblist 

(carriage return) 

include tbrun 

(carriage return) 
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What we have established in the lab so far is the following! 

A 600 tape capacity tape rack for general use. If you project 
would like to reserve a section of this tape rack* contact T i m 
McGlbbon or Bonnie Swierzbln. 

- A tape and disk cabinet for storage of system support 
materials which this project will manage and keep up to date. 
(If you have been using this cabinet for unauthorized storage 
- beware. ye have the key to the lock!) Hore will be 
published about the contents of this cabinet later* and a 
cabinet index will be posted in the lab to help locate where 
things are supposed to be placed within the cabinet. This 
cabinet is currently located in the southeast corner of the 
lab* is 6 ft* 8 in. tall* gray in color and with sliding 
door. 

— A microfiche reader and a metal box containing the most recent 
microfiche of the system compilation listings and a link map. 
These items are kept on the table to the right of the 
con sol e. 

-■ A desk documentation rack for reference manuals and Tom 
Mc6ee*s collection of "how to** goodies. The objective is to 
have this reference information at arm f s length of the 
console* but it is currently on top of the two-level unit by 
the West wall. 

— ■ At or near the console is a small notebook containing the NOS 
System Programmers Instant* NOS Application Programmer's 
Instant* and the 180 Instruction codes. 

Feel free to examine and use all of the above materials while in 
the lab. Qfi.0$i_££aai£ft-fl£._.afcU&£_au2-.fl£ - IkfiSfi-inaifiLialS*.- Please 
notify Tim HcGlbbon or Bonnie Swierzbln of any problems or 
deficiencies of these materials. Leave a note if we are not 
ava i I abl e. 
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1.0 Hardware Overview 

1.1 An Introduction to CYBER 180 

1.2 C180 Instant 

1.3 Model Independent General Design Specification - ARH1700 

2*0 NOS Reference Manuals 

2.1 XEOIT V3.0 - 60455730 

2.2 IAF VI. User»s Guide - 60455260 

2.3 NOS Reference Manual - Vol 1. 60435400 - Vol 2» 60445300 

2.4 NOS Instant 

2.5 NOS Operators Guide - 60435600 

2.6 NOS Diagnostic Handbook 

2.7 NOS A170 ERS 

2.8 NOS A170 GID - ARH3060 

3.0 NOS/VE Reference Documents 

3.1 Program Interface ERS - ARH3610 - obtained from Karen 
Rubey f 482-3966! or via SES.TOOLDGC 

3.2 Command Interface ERS - ARH3609 - obtained from Karen 
Rubey (482-3966) or via SES.T00LDOC 

3.3 NOS/VE Procedures and Conventions - SESD010 - obtained by 
SES.T00LD0C 

3.4 Listing of all NOS/VE Modules - obtained by 
SES#DEV1.LISTNVE. See Integration Procedures Notebook 
for detal Is. 

3.5 NOS/VE Internal Interface Maintenance Procedures 
Memo available from S.C. Wood. 
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3*6 Integration Procedures Notebook 

Obtained by* 

Acquire*IPNOOC/UN»DEVl. SES. PRINT, IPNDGC. 

4.0 Tools Reference Documents 

4.1 CY8IL Interactive Debugger - ARH3142 

4*2 SES User's Guide - ARH1833 

4.3 CY8IL Specification - ARH2298 

4.4 C180 Assembler ERS - ARH1693 

4.5 Simulator ERS - ARH1729 

4.6 VEGEN ERS - ARH2591 

4.7 VELINK ERS - ARH2816 

4.8 Simulated I/O ERS - ARH3125 

4.9 Object Code Utilities ERS - ARH2922 

4.10 CY8IL Implementation Dependent Handbook - ARH3078 

4.11 CYBER 180 INTERACTIVE 0E8UG External Reference 
Specification and Users Guide - S4028 
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